Make remote push the primary flow - #63

summary

big breaking change: hypeman push TARGET no longer does local pushes. those are now done with hypeman push local TARGET

• make hypeman push TARGET the Docker-like remote-push flow
• stage a matching local Docker tag into Hypeman automatically before pushing
• keep cached-image remote pushes with hypeman push IMAGE TARGET
• keep local-only uploads explicit with hypeman push local IMAGE [TARGET]
• preserve detached compatibility for push create

new push UX

Docker tag → remote registry

docker tag alpine:latest 123456789.dkr.ecr.us-east-1.amazonaws.com/myapp:v1
hypeman push 123456789.dkr.ecr.us-east-1.amazonaws.com/myapp:v1

The target must exist in the local Docker daemon. The CLI stages it into Hypeman, waits for image conversion, then queues the remote push. For an already-cached Hypeman image, use the two-argument form below.

cached Hypeman image → remote registry

hypeman push alpine:latest 123456789.dkr.ecr.us-east-1.amazonaws.com/myapp:v1

The command validates references, requires an explicit target tag, waits for completion, and reports status plus the final digest.

local Docker → Hypeman only

hypeman push local nginx:latest
hypeman push local nginx:latest myapp/nginx:v1

detached pushes

hypeman push --detach TARGET

Returns the push ID immediately. Existing hypeman push create IMAGE TARGET and hypeman push remote IMAGE TARGET remain detached compatibility forms.

status and inspection

hypeman push ls
hypeman push inspect PUSH_ID

Interactive terminals show a single updating status line. CI and piped output use plain newline status.

credentials

echo "$REGISTRY_PASSWORD" | hypeman push TARGET \
  --username USERNAME --password-stdin

The server Docker keychain remains the default when credentials are omitted.

structured output

hypeman push --format json TARGET

Direct pushes return the final result in structured formats. Add --detach to return the queued result instead.

tests

• GOCACHE=/tmp/hypeman-go-build go test ./...

follow-up

• Add server-side Hypeman image tagging, including hypeman image tag SOURCE TARGET and the corresponding API support. This is intentionally deferred so this PR remains CLI-only; the current flow stages local Docker tags as a bridge.